home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / sortf215.arc / SORTF215.DOC next >
Text File  |  1985-12-29  |  4KB  |  100 lines
  1.  
  2.                               SORTF Command
  3.  
  4.                     (c) Copyright Vernon D. Buerg 1985
  5.                       Version 2.15 - December 27, 1985
  6.  
  7.  
  8. Purpose:   The SORTF command reads data from an ASCII file, sorts the
  9.            records, and writes the data to another file.
  10.  
  11. Format:
  12.            SORTF [d:][path]fname[.ext] [d:][path]fname[.ext]
  13.                  [/+nnn[,len]]
  14.                  [/R]
  15.                  [/C]
  16.  
  17. Remarks:   Records read from the input file ending with a carriage
  18.            return and line feed are considered logical records and may
  19.            be up to 256 characters in length.
  20.  
  21.            The records are sorted into ascending ASCII character order
  22.            unless /R is supplied to reverse the order.
  23.  
  24. |          The /C option may be added to cause SORTF to treat the key
  25. |          fields as case insensitive data. That is, lower case letters
  26. |          in the key field are treated as upper case letters.
  27.  
  28.            The key is taken from the first character position, unless
  29.            the /+ operand is used to specify the location of the key
  30.            within the records. The position may be a value from one
  31.            to 255. The first 12 characters at that position are used
  32. |          as the record key unless the 'len' operand is used to
  33. |          specify the key length. The key length may be a value from
  34. |          1 to 99.
  35.  
  36.            For example, to sort a file in descending order with the
  37.            keys in position 10:
  38.  
  39.                 SORTF TEST.DAT TEST.SRT /R/+10
  40.  
  41.            Or, to sort the same file using keys with 24 characters:
  42.  
  43.                 SORTF TEST.DAT TEST.SRT /R/+10,24
  44.  
  45.            Depending on the amount of memory available, up to 40000
  46.            records, or a file up to 16-Mb, may be sorted.
  47.  
  48.            The advantages of using SORTF instead of the SORT filter are:
  49.                 - files larger than 63K may be sorted
  50.                 - less time is required
  51.  
  52.            For best results, place the input file on the fastest
  53.            available drive, e.g. RAM disk.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. Notes:
  61.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 and is
  62.         supplied for personal use. All rights reserved.
  63.  
  64.         Not for sale or hire. Commercial use is prohibited. This means
  65.         that no fee may be charged for any copies.  Nor may SORTF be
  66.         included (or bundled) with other goods or services. Exceptions
  67.         may be granted upon written request only.
  68.  
  69.         If you find SORTF useful, you are encouraged to make a contribution
  70.         to defray development costs ($10 suggested).
  71.  
  72.         For use by corporations and other institutions, contact me or
  73.         AAI Systems for a licensing agreement.
  74.  
  75.                 Vernon D. Buerg
  76.                 c/o AAI Systems, Inc.
  77.                 456 Lakeshire Drive
  78.                 Daly City, CA 94015
  79.  
  80.                 RBBS: (415) 994-2944
  81.                 CompuServe: 70007,1212
  82.  
  83.  
  84. Version History:
  85.  
  86.         2.0, July 11, 1985.
  87.            o  Corrects CR/LF problem. Remember, it is assumed that
  88.               all "records" end in a carriage return (CR). Those
  89.               that do not may appear as part of other records to
  90.               a text editor.
  91.  
  92.         2.1, August 3, 1985
  93.            o  Corrects a problem sorting files larger than 64K.
  94.  
  95.         2.15, December 27, 1985
  96. |          o  Corrects problems with first record of file.
  97. |          o  Adds /C option to treat keys as case insensitive data
  98. |          o  The key length may be specified on the command line
  99.  
  100.